home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / cli / pcommand.arc / PCOMMAND.DOC < prev    next >
Text File  |  1985-11-20  |  20KB  |  378 lines
  1.       Command Overview
  2.       Copyright (c) 1986
  3.       Solid Applications Inc.
  4.       1333 Moon Drive
  5.       Yardley, PA 19067
  6.       
  7.       
  8.       Command is a shareware product from Solid Applications Inc.
  9.       You are allowed to give a copy of the PCOMMAND.PRG program
  10.       and this documentation to anyone for no charge.  The program
  11.       may not be sold or included as part of a package for sale without
  12.       prior written approval from Solid Applications.  We encourage
  13.       you to distribute this package to your friends and coworkers who
  14.       are using the Atari ST.
  15.       
  16.       You may register your copy of PCommand with Solid Applications
  17.       for $25.00.  You will receive a copy of the full documentation
  18.       and a disk containing the desk accessory version of PCommand
  19.       along with some useful utilities including a format program which
  20.       creates diskettes that can be read on an IBM PC (both single and
  21.       double sided disks).
  22.       
  23.       
  24.       
  25.       WHAT IS PCOMMAND:
  26.       
  27.       Command  is  a  line-oriented  command  line interpreter with
  28.       batch file support.   It provides an interactive interface to Atari
  29.       TOS which runs on the Atari ST.   Commands are similar to PC-DOS
  30.       commands  PCommand provides faster access to TOS facilities than
  31.       the GEM desktop.  Multiple commands can be entered on a single line
  32.       for even better efficiency.
  33.       
  34.       Command has a number of built-in commands which are always available
  35.       and can run GEM or TOS-based applications by simply typing their name.
  36.       A list of local commands is displayed by typing HELP.  The batch file
  37.       facility can be used to present GEM-based menus and alert boxes.  This
  38.       allows a GEM interface to be built using a text editor to create a
  39.       batch file.  Most text editors available for the ST will work.
  40.       
  41.       
  42.       
  43.       SPECIAL KEYS AND EDITING
  44.       
  45.       Commands entered at the command prompt can be edited using the
  46.       following special keys.
  47.       
  48.            control-S            Suspend  output
  49.            control-Q            Continue output
  50.            control-C            Enter query mode if BREAK is ON
  51.            ESC                  same as control-C
  52.       
  53.            RETURN               Use current line as command
  54.            control-A            Move to start of line
  55.            control-B            Move forward  one character
  56.            control-C            Copy template until matching
  57.                                 character      
  58.            control-E            Move to end of line
  59.            control-F            Move backward one character
  60.            control-J            Skip to next template character
  61.            control-N            Copy next template character
  62.            control-R            Restart entry on the next line
  63.            control-T            Make current input into template
  64.            control-X            Delete current line
  65.            control-Z            Copy rest of template
  66.            ESC                  Same as control-X
  67.            Left  arrow          Same as control-B
  68.            Right arrow          Same as control-F
  69.            Home                 Same as control-R
  70.            Undo                 Same as control-Z
  71.            Shifted left  arrow  Same as control-A
  72.            Shifted right arrow  Same as control-E
  73.            Shifted Home/Clr     Same as control-X
  74.            F1                   Same as control-N
  75.            F2                   Same as control-C
  76.            F3                   Same as control-Z
  77.            F4                   Same as control-J
  78.            F5                   Same as control-T
  79.       
  80.       
  81.       BUILT-IN COMMANDS
  82.       
  83.       Command has a number of built-in commands which can be entered
  84.       directly or used in batch files.   There is also a small set of
  85.       commands which can only be used within a batch file.  The following
  86.       is a list of built-in commands.
  87.       
  88.            ?         Show built-in command list
  89.            ABORT     Show/Set Abort option
  90.            BELL      Sound bell
  91.            BREAK     Show/Set Break option
  92.            BYE       Exit from batch file/PCommand
  93.            CD        Change current directory
  94.          * CHAIN     Chain to new batch file
  95.            CHDIR     Change current directory
  96.            CLS       Clear screen
  97.            COPY      Copy file(s)
  98.            CP        Copy file(s)
  99.            CTTY      Show/set console device
  100.            DATE      Show/set date
  101.            DEL       Delete file(s)
  102.            DIR       Show directory
  103.            D         Show directory
  104.            ECHO      Set/show/display text
  105.            ERASE     Delete file(s)
  106.            ERA       Delete file(s)
  107.            EXIT      Exit from batch file/PCommand
  108.          * FOR       Iterate over file name(s)
  109.            GEM       Show/set/menu interface
  110.          * GOTO      Goto label in batch file
  111.            HELP      Show built-in command list)
  112.          * IF        Conditional command execution
  113.            INPUT     Interactive/text input
  114.            LOG       Show/set command logging status
  115.            MKDIR     Make new directory
  116.            MD        Make new directory
  117.            PATH      Show/set default search path
  118.            PAUSE     Wait for input
  119.            PRINT     Print file(s)
  120.            PROMPT    Show/set prompt
  121.            QED       Quick editor for creating batch files
  122.            REM       Remark (comment)
  123.            REN       Rename a file
  124.            RENAME    Rename a file
  125.            RESERVE   Reserve memory for program
  126.            RMDIR     Remove directory
  127.            RD        Remove directory
  128.            SET       Show/Set environment string
  129.          * SHIFT     Shift arguments
  130.            STACK     Show current execution stack
  131.            SWITCHAR  Show/set switch character
  132.            TIME      Show/set time
  133.            TOS       Execute program in TOS environment
  134.            TYPE      Type file on console
  135.            VER       Display TOS version number
  136.            VERIFY    Show/Set floppy disk verify mode
  137.            VOL       Show disk volume label
  138.            WRAP      Show/Set end of line wrap mode
  139.       
  140.       
  141.          * indicates batch file use only.
  142.       
  143.       
  144.       Multiple commands are placed on a line by separating them with
  145.       an exclamation point, '!'.  Command lines can be up to 160
  146.       characters.  Labels are the GOTO command are names immediately
  147.       preceeded by a colon, ':'.  Any text after a label is assumed to
  148.       be a comment.
  149.       
  150.       Batch file parameters are indicated by a leading percent sign, '%'.
  151.       A single digit after '%' indicates a parameter to the batch file.
  152.       The parameter relaces both the percent sign and digit.  Any of the
  153.       following special characters can be used if the percent sign is
  154.       immediately followed by a colon, ':'.
  155.       
  156.           %:c       first character from last INPUT result
  157.           %:d       disk letter from last GEM :FILE command
  158.           %:e       ERRORLEVEL from last program
  159.           %:f       file name   from last GEM :FILE command
  160.           %:i       string from last INPUT result
  161.           %:p       path name   from last GEM :FILE command
  162.           %:v       video mode (0=low, 1=medium, 2=mono)
  163.           %::       current time
  164.           %:/       current date
  165.       
  166.       
  167.       BUILT-IN COMMANDS
  168.       
  169.       General syntax: optional items are placed within square
  170.       brackets such as [XYZ].  Alternatives are separated by a
  171.       vertical bar as with ON|OFF.  Repeated items are followed by
  172.       ellipses (...).  Note, keywords do not have to be capitalized
  173.       when used.
  174.       
  175.            ?                   Help command, no parameters,
  176.                                print built-in commands
  177.            ABORT [ON|OFF]      Set/show ABORT flag, OFF indicates
  178.                                termination when BREAK is ON and a
  179.                                control-C or ESC key is pressed.
  180.                                ON prints the STACK status and allow